============================================================
AQQD – Annotated Quranic Qira’at Dataset (Version 1)
README FIRST
============================================================

This file explains how to download, extract, and understand the
Annotated Quranic Qira’at Dataset (AQQD). Please read this file
before using the dataset.

------------------------------------------------------------
1. Dataset Overview
------------------------------------------------------------

The Annotated Quranic Qira’at Dataset (AQQD) is a collection of
Quran recitations from 308 individual reciters.

Each reciter is stored in a separate folder and contains audio
files corresponding to specific Surahs and Ayahs of the Quran.

The dataset is intended for research purposes, including but not
limited to:
- Quranic and Islamic studies
- Speech and audio processing
- Phonetics and prosody analysis
- Machine learning and speech recognition
- Cultural and religious studies

------------------------------------------------------------
2. Dataset Structure
------------------------------------------------------------

After extraction, the dataset folder will appear as:

AQQDv1/
 ├── Reciter_001/
 ├── Reciter_002/
 ├── ...
 └── Reciter_308/

Each reciter folder contains audio files organized by Surah and
Ayah. File and folder names are consistent across the dataset.

------------------------------------------------------------
3. Metadata (IMPORTANT)
------------------------------------------------------------

The file named:

AQQD_details.xlsx

is the PRIMARY metadata reference for this dataset.

Researchers should use this Excel file to identify:
- Reciter identifiers
- Recitation styles
- Associated Surahs
- Ayahs (verses) for each Surah
- Mapping between audio files and Quranic content

The Excel file should always be consulted when interpreting
the audio data.

------------------------------------------------------------
4. Download Instructions
------------------------------------------------------------

Due to the large size of the dataset, the data is distributed
as a multi-part ZIP archive.

You must download ALL of the following files into the SAME folder:

AQQD_Dataset.zip.001
AQQD_Dataset.zip.002
AQQD_Dataset.zip.003
AQQD_Dataset.zip.004
AQQD_Dataset.zip.005
AQQD_Dataset.zip.005
AQQD_Dataset.zip.006
AQQD_Dataset.zip.007
AQQD_Dataset.zip.008
AQQD_Dataset.zip.009
AQQD_Dataset.zip.010

All parts are required for successful extraction.

------------------------------------------------------------
5. Software Requirement
------------------------------------------------------------

To extract the dataset, install 7-Zip:

https://www.7-zip.org/

7-Zip is free and available for Windows, macOS, and Linux.
Other archive tools that support multi-part ZIP files may also work.

------------------------------------------------------------
6. Extraction Instructions (IMPORTANT)
------------------------------------------------------------

1. Ensure ALL ZIP parts (.zip.001, .zip.002, etc.) are located
   in the same folder.

2. Right-click ONLY the file:
   AQQD_Dataset.zip.001

3. Select:
   7-Zip → Extract Here
   or
   7-Zip → Extract to "AQQDv1\"

IMPORTANT NOTES:
- Do NOT attempt to extract each ZIP part individually.
- Do NOT rename the ZIP files.
- 7-Zip will automatically use all parts during extraction.

------------------------------------------------------------
7. Version Information
------------------------------------------------------------

Dataset version: AQQDv1

Future updates or corrections will be released as new versions.

------------------------------------------------------------
8. Citation
------------------------------------------------------------

Please cite this dataset using the citation provided by
Harvard Dataverse.

------------------------------------------------------------
9. License and Usage
------------------------------------------------------------

Please refer to the license information provided in the
Harvard Dataverse record. Users must comply with the stated
terms of use.

------------------------------------------------------------
End of README
------------------------------------------------------------
